Conducting linguistics research online

A practical introduction using jsPsych and cognition.run

Translations available

Disclaimer: may not be very accurate…

Worksheet overview

Aims

By the end of this worksheet you should be able to:

  • program your own experiments in jsPsych
  • host the experiment online using cognition.run
  • use the participant data for analysis
  • apply the basic skills you have learnt for your own purposes
  • learn some extra skills such as HTML, javascript, CSS and JSON

Pre-requisites

To complete the aims you will need to:

  • follow this worksheet
  • ask questions if you are not sure/be able to google
  • have a working computer and internet connection
  • be patient when things do not work

You do not need to:

  • have any programming knowledge
  • have high computer literacy
  • know anything about jsPsych, cognition.run, html, css or javascript
  • be a linguist

Structure

The worksheet will go through the following sections:

  • Introducing cognition.run

    • creating an account
    • creating a new experiment
    • familiarisation with the interface

  • Introducing jsPsych

Introducing cognition.run and jsPsych

cognition.run

What is it?

A free and easy way to host your jsPsych experiments.

Why would I use it?

If you do not have access to your own server, or do not want to pay for alternative online server options, this is a nice and simple solution for researchers.

Do I have to spend lots of time learning how it works?

Not really, once you learn how to use jsPsych the interface is really good for beginners to navigate and use.

The free account will allow you to:

  • run your jsPsych experiments online
  • code and preview your experiment
  • access your data as a csv file
  • collect a maximum of 80 participants per experiment
  • learn the basics and complete this worksheet

It will not be suitable if you:

  • need to collect a large amount of data from lots of participants
  • collect data that would not be usable in csv format (e.g. audio recordings from participants)
  • have stimuli that are very large in size (>2 MB, e.g. videos)
  • are looking to host your experiments on your own server
  • generally have more complex experimental designs

Setting up an account

  1. Go to https://www.cognition.run/ and click on the create an account button.

  2. Register for a free account by filling in the form.

  3. You will then see a dashboard, where you can see your experiments. Click on the + New task button to create a new experiment.

  4. Where it says task name type the name demo (you can choose a different name if you want, but this is the name that we will use). If you click on the Show advanced configuration button to see additional settings, which may be relevant depending on your ethics application (e.g. data storage location, IP address logging). Click the Save button to create the experiment.

  5. Now you will see the experiment’s dashboard. There are several options on this page which we will cover later, but for now we need to click on the Source code button.

  6. On this page you can start writing your code that makes your experiment. Before we start writing our code we will need to know how jsPsych works, which will be covered in the next section. We will return to the cognition.run interface too and see how to interact with it in more detail.

Things might look different

The screenshots above might look different if you are reading this worksheet at a later date. This is because websites change, especially ones that are constantly developing, which also means the cost of using the service might also change.

jsPsych

What is it?
A free and open source library that allows users to create and run experiments online. It relies on javascript, a programming language that most websites use, to implement plugins that can be used to make your experiments.

See:

https://www.jspsych.org/

de Leeuw, J. R. (2015). jsPsych: A JavaScript library for creating behavioral experiments in a web browser. Behavior Research Methods, 47(1), 1-12. doi:10.3758/s13428-014-0458-y.

Why should I use it?
It is an extremely adaptable and easy to use, with a growing community of users, support and contributors, making it more accessible for everybody to conduct research online. It is also free and open source.

Do I have to spend lots of time learning how to use it?
Probably. There is definitely a learning curve, which will take time to get around, but you learn lots of skills along the way. The more you learn, the more you can do. However, if you want to learn the basics you do not need too long to get a working experiment programmed and available to participants.

Should I be worried if I do not know what javascript is?
No. The great thing about jsPsych is that much of the hard work is already done by others, which means you can get by without worrying about the really complex stuff.

Versions of jsPsych

You might have noticed that jsPsych has different versions, e.g. 7.3.1, 6.3.0. This is somewhat confusing at first as you would hope that there would be no major differences in which version you are using, or that you would just choose the latest version. However, there are some important differences between the versions that can affect whether your script will work. These are largely based on whether you are using version 6.x.x or 7.x.x

In this tutorial we will be using version 7.3.1

You can see an outline of the differences at https://www.jspsych.org/7.3/support/migration-v7/

Always try to write somewhere in your script which version of jsPsych you are working with.

Running experiments

In order to run your experiments, you have write code that will tell jsPsych what you want it to do. This requires you to speak the same way as jsPsych, so that your instructions can be interpreted properly.

Imagine you have to guide somebody from point A to point B on a map, you will have to learn how to give basic instructions like turn left, stop, continue, this is what your code will have to do (but in the context of a linguistics experiment, so more like show this stimuli, collect this input, measure the time it takes to press this button).

Using cognition.run with jsPsych

To run your experiment, you will need somewhere to write your code. We will therefore return to cognition.run.

The image below outlines which parts of the interface can be used for different purposes. For now, we will focus on 1 and 2 of the interface (writing code and previewing how it looks), with 3 and 4 being explained in more detail later.

0. Commenting your code

Before you start writing proper code that does things, it is important to remember that it is not just the computer who will interpret you write… you and other human brains need to as well.

To make it easier for humans, you can add comments to your code.

Comments don’t do anything to your actual code, but add information to make it easier to understand and interpret. Imagine talking to somebody in a language that you both know, but there is somebody else in the group who does not speak that language, so you might offer a simplified translation to that person, so that they know what is happening. This is sort of similar to what comments do.

You can write a comment in the code section of the cognition.run interface in the following way:

/* This is a comment */

These can be as long as you want, but must have /* at the start, and */ at the end.

Let’s try writing a useful comment in our script, where we say:

  • the title of the experiment
  • what version of jsPsych we are using
  • when we wrote the code [today]
  • who is the author of the code [your name]
/*
Title: My first experiment
jsPsych version: 7.3.1
date: [today]
author: [your name]
*/

1. Initiating jsPsych

Now we can start writing actual code that will allow us to use jsPsych properly.

In order for your experiment to work, the first line of code in your script should be:

var jsPsych = initJsPsych();

Notice that this is not a comment and has a specific structure, or syntax, which is shown by the colour highlighting of the text. We can deconstruct this to understand each part of the code:

  • var this indicates that we want to create a variable, which we can use in our experiment.
    Notice that it is in a different colour to the rest of the text, this is because it is a keyword that javascript understands to be important, i.e. that you want to create a variable.

  • jsPsych this is the name of our variable, in theory you can name variables anything that you want.

  • = this is an operator it is used to assign a value to a variable, in this case whatever is on the right of the equals sign will be assigned to our jsPsych variable.

  • initJsPsych() this is a function specifically made for jsPsych experiments, it allows us to initiate an experiment, without this function we would not be able to do anything. Think of it as turning on the power button, nothing will happen until you have this function stored as a variable.

  • ; this is a semi-colon, it is an important part of your code as it will allow the script to know that your specific bit of code (or statement) is finished and you can move on to your next one.

What is a variable?

See this page for more information on what var means.

Choosing a name for your variable

When naming your variable you should follow these rules:

never include spaces (use_underscores_instead)
never begin with a number
never use a special javascript name (e.g. ‘var’ is not a good name for your variable)

always make them unique to other variables
always make them memorable
always be aware of upper and lower case (‘myVariable’ will be distinct from ‘myvariable’)

What goes inside the brackets?

When you see brackets for a function, there are normally some additional parameters that you can set, to see what these are you can always refer to the official jsPsych documentation, for now we will keep our experiment to the default settings, so we do not need to add anything inside the brackets.

Important differences between cognition.run and normal jsPsych experiments

Your experiment in cognition.run will look a but different from other JsPsysch experiments, e.g. the ones you might see that were hosted on private servers. This is because cognition.run does some things automatically, so you do not need to worry about adding specific code.

One of the main differences is that all of the standard JsPsych plugins are automatically loaded for you. We will discuss this later in the worksheet, but if you have used JsPsych before, or are copying code from a non cognition.run experiment you might need to be aware of this.

Essentially, the code you have in your cognition.run experiment will all be javascript, whereas a typical JsPsych experiment will be a html file, with the javascript embedded within that file.

LS0tCnRpdGxlOiAiQ29uZHVjdGluZyBsaW5ndWlzdGljcyByZXNlYXJjaCBvbmxpbmUiCnN1YnRpdGxlOiAiQSBwcmFjdGljYWwgaW50cm9kdWN0aW9uIHVzaW5nIGpzUHN5Y2ggYW5kIGNvZ25pdGlvbi5ydW4iCmF1dGhvcjogIkphbWVzIEJyYW5kIgpkYXRlOiAiYHIgZm9ybWF0KFN5cy50aW1lKCksICclZCAlQiwgJVknKWAiCm91dHB1dDoKICBybWRmb3JtYXRzOjpyZWFkdGhlZG93bjoKICAgICMgcGFuZG9jX2FyZ3M6ICItLWhpZ2hsaWdodC1zdHlsZT1teS50aGVtZSIKICAgIGhpZ2hsaWdodDogcHlnbWVudHMKICAgIHRvY19mbG9hdDogdHJ1ZQogICAgY29kZV9kb3dubG9hZDogdHJ1ZQogICAgdG9jX2RlcHRoOiAzCiAgICBjb2xsYXBzZWQ6IGZhbHNlCiAgICBkZl9wcmludDogcGFnZWQKICAgIGxpZ2h0Ym94OiBUUlVFCiAgICBnYWxsZXJ5OiBUUlVFCiAgICBjc3M6ICJjc3Mvc3R5bGUuY3NzIgogICAgCi0tLQoKYGBge3IgZWNobz1GQUxTRSwgd2FybmluZz1GQUxTRX0KbGlicmFyeShzbGlja1IpCmxpYnJhcnkoaHRtbHRvb2xzKQpsaWJyYXJ5KHhhcmluZ2FuRXh0cmEpCmxpYnJhcnkocm1hcmtkb3duKQpsaWJyYXJ5KGZvbnRhd2Vzb21lKQpsaWJyYXJ5KGJzcGx1cykKCmBgYAoKYGBge3Igc2V0dXAsIHdhcm5pbmc9RkFMU0UsIGVjaG89RkFMU0V9CmtuaXRyOjpvcHRzX2NodW5rJHNldChlY2hvID0gVFJVRSwKICAgICAgICAgICAgICAgICAgICAgIGV2YWwgPSBGQUxTRSwKICAgICAgICAgICAgICAgICAgICAgIGNvbW1lbnQgPSBOQSkKCmtuaXRyOjprbml0X2hvb2tzJHNldCgKICBtZXNzYWdlID0gZnVuY3Rpb24oeCwgb3B0aW9ucykgewogICAgIHBhc3RlKCc8YnV0dG9uIHR5cGU9ImJ1dHRvbiIgY2xhc3M9ImNvbGxhcHNpYmxlMSI+PHN0cm9uZz4nLAogICAgIGZhKG5hbWUgPSAiY2lyY2xlLWluZm8iKSwKICAgICAnIG1vcmUgaW5mbzwvc3Ryb25nPjwvYnV0dG9uPjxkaXYgY2xhc3M9ImNvbnRlbnQxIj48cD4nLAogICAgIGdzdWIoJyMjJywgJ1xuJywgeCksCiAgICAgJzwvcD48L2Rpdj4nLAogICAgIHNlcCA9ICdcbicpCiAgIH0pCgpjb2RlYmxvY2sgPSBmdW5jdGlvbih4LCBvcHRpb25zKSB7CiAgICAgY2F0KHBhc3RlKCc8ZGl2IGNsYXNzPSJjb2RlYmxvY2siPicsCiAgICAgcGFzdGUwKHgpLAogICAgICc8L2Rpdj4nLAogICAgIHNlcCA9ICdcbicpKQogICB9CgpgYGAKCi0tLQoKIyMgYHIgZmEoImxhbmd1YWdlIilgIFRyYW5zbGF0aW9ucyBhdmFpbGFibGUKCkRpc2NsYWltZXI6IG1heSBub3QgYmUgdmVyeSBhY2N1cmF0ZS4uLgoKPGRpdiBpZD0iZ29vZ2xlX3RyYW5zbGF0ZV9lbGVtZW50Ij48L2Rpdj4KCi0tLQoKIyBXb3Jrc2hlZXQgb3ZlcnZpZXcKCiMjIGByIGZhKCJjcm9zc2hhaXJzIilgIEFpbXMKCkJ5IHRoZSBlbmQgb2YgdGhpcyB3b3Jrc2hlZXQgeW91IHNob3VsZCBiZSBhYmxlIHRvOgoKLSAqKnByb2dyYW0qKiB5b3VyIG93biBleHBlcmltZW50cyBpbiBqc1BzeWNoCi0gKipob3N0KiogdGhlIGV4cGVyaW1lbnQgb25saW5lIHVzaW5nIGNvZ25pdGlvbi5ydW4KLSAqKnVzZSoqIHRoZSBwYXJ0aWNpcGFudCBkYXRhIGZvciBhbmFseXNpcwotICoqYXBwbHkqKiB0aGUgYmFzaWMgc2tpbGxzIHlvdSBoYXZlIGxlYXJudCBmb3IgeW91ciBvd24gcHVycG9zZXMKLSAqKmxlYXJuKiogc29tZSBleHRyYSBza2lsbHMgc3VjaCBhcyBIVE1MLCBqYXZhc2NyaXB0LCBDU1MgYW5kIEpTT04KCiMjIGByIGZhKCJ1c2VyLWdyYWR1YXRlIilgIFByZS1yZXF1aXNpdGVzCgpUbyBjb21wbGV0ZSB0aGUgYWltcyB5b3Ugd2lsbCBuZWVkIHRvOgoKLSAqKmZvbGxvdyoqIHRoaXMgd29ya3NoZWV0Ci0gKiphc2sqKiBxdWVzdGlvbnMgaWYgeW91IGFyZSBub3Qgc3VyZS9iZSBhYmxlIHRvIGdvb2dsZQotICoqaGF2ZSoqIGEgd29ya2luZyBjb21wdXRlciBhbmQgaW50ZXJuZXQgY29ubmVjdGlvbgotICoqYmUgcGF0aWVudCoqIHdoZW4gdGhpbmdzIGRvIG5vdCB3b3JrCgpZb3UgZG8gbm90IG5lZWQgdG86CgotIGhhdmUgYW55ICoqcHJvZ3JhbW1pbmcga25vd2xlZGdlKioKLSBoYXZlIGhpZ2ggKipjb21wdXRlciBsaXRlcmFjeSoqCi0ga25vdyBhbnl0aGluZyBhYm91dCAqKmpzUHN5Y2gsIGNvZ25pdGlvbi5ydW4sIGh0bWwsIGNzcyBvciBqYXZhc2NyaXB0KioKLSBiZSBhICoqbGluZ3Vpc3QqKgoKIyMgYHIgZmEoImZvbGRlci10cmVlIilgIFN0cnVjdHVyZQoKVGhlIHdvcmtzaGVldCB3aWxsIGdvIHRocm91Z2ggdGhlIGZvbGxvd2luZyBzZWN0aW9uczoKCi0gSW50cm9kdWNpbmcgY29nbml0aW9uLnJ1bgoKICAgIC0gY3JlYXRpbmcgYW4gYWNjb3VudAogICAgLSBjcmVhdGluZyBhIG5ldyBleHBlcmltZW50CiAgICAtIGZhbWlsaWFyaXNhdGlvbiB3aXRoIHRoZSBpbnRlcmZhY2UKPGJyLz48YnIvPgotIEludHJvZHVjaW5nIGpzUHN5Y2gKCiAgICAtIAoKLS0tCgojIEludHJvZHVjaW5nIGNvZ25pdGlvbi5ydW4gYW5kIGpzUHN5Y2gKCiMjIGNvZ25pdGlvbi5ydW4KCioqV2hhdCBpcyBpdD8qKgoKQSBmcmVlIGFuZCBlYXN5IHdheSB0byBob3N0IHlvdXIganNQc3ljaCBleHBlcmltZW50cy4KCioqV2h5IHdvdWxkIEkgdXNlIGl0PyoqCgpJZiB5b3UgZG8gbm90IGhhdmUgYWNjZXNzIHRvIHlvdXIgb3duIHNlcnZlciwgb3IgZG8gbm90IHdhbnQgdG8gcGF5IGZvciBhbHRlcm5hdGl2ZSBvbmxpbmUgc2VydmVyIG9wdGlvbnMsIHRoaXMgaXMgYSBuaWNlIGFuZCBzaW1wbGUgc29sdXRpb24gZm9yIHJlc2VhcmNoZXJzLgoKKipEbyBJIGhhdmUgdG8gc3BlbmQgbG90cyBvZiB0aW1lIGxlYXJuaW5nIGhvdyBpdCB3b3Jrcz8qKgoKTm90IHJlYWxseSwgb25jZSB5b3UgbGVhcm4gaG93IHRvIHVzZSBqc1BzeWNoIHRoZSBpbnRlcmZhY2UgaXMgcmVhbGx5IGdvb2QgZm9yIGJlZ2lubmVycyB0byBuYXZpZ2F0ZSBhbmQgdXNlLgoKKipUaGUgZnJlZSBhY2NvdW50IHdpbGwgYWxsb3cgeW91IHRvOioqCgotIHJ1biB5b3VyIGpzUHN5Y2ggZXhwZXJpbWVudHMgb25saW5lCi0gY29kZSBhbmQgcHJldmlldyB5b3VyIGV4cGVyaW1lbnQKLSBhY2Nlc3MgeW91ciBkYXRhIGFzIGEgY3N2IGZpbGUKLSBjb2xsZWN0IGEgbWF4aW11bSBvZiA4MCBwYXJ0aWNpcGFudHMgcGVyIGV4cGVyaW1lbnQKLSBsZWFybiB0aGUgYmFzaWNzIGFuZCBjb21wbGV0ZSB0aGlzIHdvcmtzaGVldAoKKipJdCB3aWxsIG5vdCBiZSBzdWl0YWJsZSBpZiB5b3U6KioKCi0gbmVlZCB0byBjb2xsZWN0IGEgbGFyZ2UgYW1vdW50IG9mIGRhdGEgZnJvbSBsb3RzIG9mIHBhcnRpY2lwYW50cwotIGNvbGxlY3QgZGF0YSB0aGF0IHdvdWxkIG5vdCBiZSB1c2FibGUgaW4gY3N2IGZvcm1hdCAoZS5nLiBhdWRpbyByZWNvcmRpbmdzIGZyb20gcGFydGljaXBhbnRzKQotIGhhdmUgc3RpbXVsaSB0aGF0IGFyZSB2ZXJ5IGxhcmdlIGluIHNpemUgKD4yIE1CLCBlLmcuIHZpZGVvcykKLSBhcmUgbG9va2luZyB0byBob3N0IHlvdXIgZXhwZXJpbWVudHMgb24geW91ciBvd24gc2VydmVyCi0gZ2VuZXJhbGx5IGhhdmUgbW9yZSBjb21wbGV4IGV4cGVyaW1lbnRhbCBkZXNpZ25zCgojIyMgU2V0dGluZyB1cCBhbiBhY2NvdW50CgpgYGB7ciBlY2hvPUZBTFNFLCBldmFsPVRSVUV9CnNsaWNrUihvYmo9YygiaW1hZ2VzL2NvZ25pdGlvbjEucG5nIiwiaW1hZ2VzL2NvZ25pdGlvbjIucG5nIiwgImltYWdlcy9jb2duaXRpb24zLnBuZyIsImltYWdlcy9jb2duaXRpb240LnBuZyIsICJpbWFnZXMvY29nbml0aW9uNS5wbmciLCAiaW1hZ2VzL2NvZ25pdGlvbjYucG5nIiksIHdpZHRoID0gIjk1JSIsIGhlaWdodCA9IDMwMCkgICsgCiAgc2V0dGluZ3MoZG90cyA9IFRSVUUsIGZvY3VzT25TZWxlY3QgPSBUUlVFLCBjdXN0b21QYWdpbmcgPSBodG1sd2lkZ2V0czo6SlMoImZ1bmN0aW9uKHNsaWNrLGluZGV4KSB7CiAgICAgICAgICAgICAgICAgICAgICAgICAgICByZXR1cm4gJzxhIHN0eWxlPVwiZm9udC1mYW1pbHk6YXJpYWw7Y29sb3I6IzlGMUY0MjtcIj4nKyhpbmRleCsxKSsnPC9hPic7CiAgICAgICAgICAgICAgICAgICAgICAgfSIpKQoKYGBgCgoKMS4gR28gdG8gW2h0dHBzOi8vd3d3LmNvZ25pdGlvbi5ydW4vXShodHRwczovL3d3dy5jb2duaXRpb24ucnVuLykgYW5kIGNsaWNrIG9uIHRoZSBgY3JlYXRlIGFuIGFjY291bnRgIGJ1dHRvbi48YnIvPjxici8+CgoyLiBSZWdpc3RlciBmb3IgYSBmcmVlIGFjY291bnQgYnkgZmlsbGluZyBpbiB0aGUgZm9ybS48YnIvPjxici8+CgozLiBZb3Ugd2lsbCB0aGVuIHNlZSBhIGRhc2hib2FyZCwgd2hlcmUgeW91IGNhbiBzZWUgeW91ciBleHBlcmltZW50cy4gQ2xpY2sgb24gdGhlIGArIE5ldyB0YXNrYCBidXR0b24gdG8gY3JlYXRlIGEgbmV3IGV4cGVyaW1lbnQuPGJyLz48YnIvPgoKNC4gV2hlcmUgaXQgc2F5cyBgdGFzayBuYW1lYCB0eXBlIHRoZSBuYW1lICoqZGVtbyoqICh5b3UgY2FuIGNob29zZSBhIGRpZmZlcmVudCBuYW1lIGlmIHlvdSB3YW50LCBidXQgdGhpcyBpcyB0aGUgbmFtZSB0aGF0IHdlIHdpbGwgdXNlKS4gSWYgeW91IGNsaWNrIG9uIHRoZSBgU2hvdyBhZHZhbmNlZCBjb25maWd1cmF0aW9uYCBidXR0b24gdG8gc2VlIGFkZGl0aW9uYWwgc2V0dGluZ3MsIHdoaWNoIG1heSBiZSByZWxldmFudCBkZXBlbmRpbmcgb24geW91ciBldGhpY3MgYXBwbGljYXRpb24gKGUuZy4gZGF0YSBzdG9yYWdlIGxvY2F0aW9uLCBJUCBhZGRyZXNzIGxvZ2dpbmcpLiBDbGljayB0aGUgYFNhdmVgIGJ1dHRvbiB0byBjcmVhdGUgdGhlIGV4cGVyaW1lbnQuPGJyLz48YnIvPgoKNS4gTm93IHlvdSB3aWxsIHNlZSB0aGUgZXhwZXJpbWVudCdzIGRhc2hib2FyZC4gVGhlcmUgYXJlIHNldmVyYWwgb3B0aW9ucyBvbiB0aGlzIHBhZ2Ugd2hpY2ggd2Ugd2lsbCBjb3ZlciBsYXRlciwgYnV0IGZvciBub3cgd2UgbmVlZCB0byBjbGljayBvbiB0aGUgYFNvdXJjZSBjb2RlYCBidXR0b24uPGJyLz48YnIvPgoKNi4gT24gdGhpcyBwYWdlIHlvdSBjYW4gc3RhcnQgd3JpdGluZyB5b3VyIGNvZGUgdGhhdCBtYWtlcyB5b3VyIGV4cGVyaW1lbnQuIEJlZm9yZSB3ZSBzdGFydCB3cml0aW5nIG91ciBjb2RlIHdlIHdpbGwgbmVlZCB0byBrbm93IGhvdyBqc1BzeWNoIHdvcmtzLCB3aGljaCB3aWxsIGJlIGNvdmVyZWQgaW4gdGhlIG5leHQgc2VjdGlvbi4gV2Ugd2lsbCByZXR1cm4gdG8gdGhlIGNvZ25pdGlvbi5ydW4gaW50ZXJmYWNlIHRvbyBhbmQgc2VlIGhvdyB0byBpbnRlcmFjdCB3aXRoIGl0IGluIG1vcmUgZGV0YWlsLjxici8+PGJyLz4KCmBgYHtyIGVjaG89RkFMU0UsIGV2YWw9VFJVRSwgcmVzdWx0cz0nbWFya3VwJ30KbWVzc2FnZShwYXN0ZSgiPGI+VGhpbmdzIG1pZ2h0IGxvb2sgZGlmZmVyZW50PC9iPiIsCiAgICAgICAgICAgICAgIlRoZSBzY3JlZW5zaG90cyBhYm92ZSBtaWdodCBsb29rIGRpZmZlcmVudCBpZiB5b3UgYXJlIHJlYWRpbmcgdGhpcyB3b3Jrc2hlZXQgYXQgYSBsYXRlciBkYXRlLiBUaGlzIGlzIGJlY2F1c2Ugd2Vic2l0ZXMgY2hhbmdlLCBlc3BlY2lhbGx5IG9uZXMgdGhhdCBhcmUgY29uc3RhbnRseSBkZXZlbG9waW5nLCB3aGljaCBhbHNvIG1lYW5zIHRoZSBjb3N0IG9mIHVzaW5nIHRoZSBzZXJ2aWNlIG1pZ2h0IGFsc28gY2hhbmdlLiIsCiAgICAgICAgICAgICAgc2VwID0gIjxici8+PGJyLz4iKSkKYGBgCgotLS0KCiMjIGpzUHN5Y2gKCioqV2hhdCBpcyBpdD8qKjxici8+CkEgZnJlZSBhbmQgb3BlbiBzb3VyY2UgbGlicmFyeSB0aGF0IGFsbG93cyB1c2VycyB0byBjcmVhdGUgYW5kIHJ1biBleHBlcmltZW50cyBvbmxpbmUuIEl0IHJlbGllcyBvbiAqamF2YXNjcmlwdCosIGEgcHJvZ3JhbW1pbmcgbGFuZ3VhZ2UgdGhhdCBtb3N0IHdlYnNpdGVzIHVzZSwgdG8gaW1wbGVtZW50ICpwbHVnaW5zKiB0aGF0IGNhbiBiZSB1c2VkIHRvIG1ha2UgeW91ciBleHBlcmltZW50cy4KClNlZToKCltodHRwczovL3d3dy5qc3BzeWNoLm9yZy9dKGh0dHBzOi8vd3d3LmpzcHN5Y2gub3JnLykKCmRlIExlZXV3LCBKLiBSLiAoMjAxNSkuIGpzUHN5Y2g6IEEgSmF2YVNjcmlwdCBsaWJyYXJ5IGZvciBjcmVhdGluZyBiZWhhdmlvcmFsIGV4cGVyaW1lbnRzIGluIGEgd2ViIGJyb3dzZXIuICpCZWhhdmlvciBSZXNlYXJjaCBNZXRob2RzKiwgNDcoMSksIDEtMTIuIFtkb2k6MTAuMzc1OC9zMTM0MjgtMDE0LTA0NTgteV0oaHR0cHM6Ly9kb2kub3JnLzEwLjM3NTgvczEzNDI4LTAxNC0wNDU4LXkpLgoKKipXaHkgc2hvdWxkIEkgdXNlIGl0PyoqPGJyLz4KSXQgaXMgYW4gZXh0cmVtZWx5IGFkYXB0YWJsZSBhbmQgZWFzeSB0byB1c2UsIHdpdGggYSBncm93aW5nIGNvbW11bml0eSBvZiB1c2Vycywgc3VwcG9ydCBhbmQgY29udHJpYnV0b3JzLCBtYWtpbmcgaXQgbW9yZSBhY2Nlc3NpYmxlIGZvciBldmVyeWJvZHkgdG8gY29uZHVjdCByZXNlYXJjaCBvbmxpbmUuIEl0IGlzIGFsc28gZnJlZSBhbmQgb3BlbiBzb3VyY2UuCgoqKkRvIEkgaGF2ZSB0byBzcGVuZCBsb3RzIG9mIHRpbWUgbGVhcm5pbmcgaG93IHRvIHVzZSBpdD8qKjxici8+ClByb2JhYmx5LiBUaGVyZSBpcyBkZWZpbml0ZWx5IGEgbGVhcm5pbmcgY3VydmUsIHdoaWNoIHdpbGwgdGFrZSB0aW1lIHRvIGdldCBhcm91bmQsIGJ1dCB5b3UgbGVhcm4gbG90cyBvZiBza2lsbHMgYWxvbmcgdGhlIHdheS4gVGhlIG1vcmUgeW91IGxlYXJuLCB0aGUgbW9yZSB5b3UgY2FuIGRvLiBIb3dldmVyLCBpZiB5b3Ugd2FudCB0byBsZWFybiB0aGUgYmFzaWNzIHlvdSBkbyBub3QgbmVlZCB0b28gbG9uZyB0byBnZXQgYSB3b3JraW5nIGV4cGVyaW1lbnQgcHJvZ3JhbW1lZCBhbmQgYXZhaWxhYmxlIHRvIHBhcnRpY2lwYW50cy4KCioqU2hvdWxkIEkgYmUgd29ycmllZCBpZiBJIGRvIG5vdCBrbm93IHdoYXQgamF2YXNjcmlwdCBpcz8qKjxici8+Ck5vLiBUaGUgZ3JlYXQgdGhpbmcgYWJvdXQganNQc3ljaCBpcyB0aGF0IG11Y2ggb2YgdGhlIGhhcmQgd29yayBpcyBhbHJlYWR5IGRvbmUgYnkgb3RoZXJzLCB3aGljaCBtZWFucyB5b3UgY2FuIGdldCBieSB3aXRob3V0IHdvcnJ5aW5nIGFib3V0IHRoZSByZWFsbHkgY29tcGxleCBzdHVmZi4KCmBgYHtyIGVjaG89RkFMU0UsIGV2YWw9VFJVRX0KbWVzc2FnZShwYXN0ZSgiPGI+VmVyc2lvbnMgb2YganNQc3ljaDwvYj4iLAogICAgICAgICAgICAgICJZb3UgbWlnaHQgaGF2ZSBub3RpY2VkIHRoYXQganNQc3ljaCBoYXMgZGlmZmVyZW50IHZlcnNpb25zLCBlLmcuIDcuMy4xLCA2LjMuMC4gVGhpcyBpcyBzb21ld2hhdCBjb25mdXNpbmcgYXQgZmlyc3QgYXMgeW91IHdvdWxkIGhvcGUgdGhhdCB0aGVyZSB3b3VsZCBiZSBubyBtYWpvciBkaWZmZXJlbmNlcyBpbiB3aGljaCB2ZXJzaW9uIHlvdSBhcmUgdXNpbmcsIG9yIHRoYXQgeW91IHdvdWxkIGp1c3QgY2hvb3NlIHRoZSBsYXRlc3QgdmVyc2lvbi4gSG93ZXZlciwgdGhlcmUgYXJlIHNvbWUgaW1wb3J0YW50IGRpZmZlcmVuY2VzIGJldHdlZW4gdGhlIHZlcnNpb25zIHRoYXQgY2FuIGFmZmVjdCB3aGV0aGVyIHlvdXIgc2NyaXB0IHdpbGwgd29yay4gVGhlc2UgYXJlIGxhcmdlbHkgYmFzZWQgb24gd2hldGhlciB5b3UgYXJlIHVzaW5nIHZlcnNpb24gNi54Lnggb3IgNy54LngiLAogICAgICAgICAgICAgICJJbiB0aGlzIHR1dG9yaWFsIHdlIHdpbGwgYmUgdXNpbmcgPGI+dmVyc2lvbiA3LjMuMTwvYj4iLAogICAgICAgICAgICAgICJZb3UgY2FuIHNlZSBhbiBvdXRsaW5lIG9mIHRoZSBkaWZmZXJlbmNlcyBhdCA8YT5odHRwczovL3d3dy5qc3BzeWNoLm9yZy83LjMvc3VwcG9ydC9taWdyYXRpb24tdjcvPC9hPiIsCiAgICAgICAgICAgICAgIkFsd2F5cyB0cnkgdG8gd3JpdGUgc29tZXdoZXJlIGluIHlvdXIgc2NyaXB0IHdoaWNoIHZlcnNpb24gb2YganNQc3ljaCB5b3UgYXJlIHdvcmtpbmcgd2l0aC4iLAogICAgICAgICAgICAgIHNlcCA9ICI8YnIvPjxici8+IikpCgpgYGAKCi0tLQoKIyBSdW5uaW5nIGV4cGVyaW1lbnRzCgpJbiBvcmRlciB0byBydW4geW91ciBleHBlcmltZW50cywgeW91IGhhdmUgd3JpdGUgY29kZSB0aGF0IHdpbGwgdGVsbCBqc1BzeWNoIHdoYXQgeW91IHdhbnQgaXQgdG8gZG8uIFRoaXMgcmVxdWlyZXMgeW91IHRvIHNwZWFrIHRoZSBzYW1lIHdheSBhcyBqc1BzeWNoLCBzbyB0aGF0IHlvdXIgaW5zdHJ1Y3Rpb25zIGNhbiBiZSBpbnRlcnByZXRlZCBwcm9wZXJseS4KCkltYWdpbmUgeW91IGhhdmUgdG8gZ3VpZGUgc29tZWJvZHkgZnJvbSBwb2ludCBBIHRvIHBvaW50IEIgb24gYSBtYXAsIHlvdSB3aWxsIGhhdmUgdG8gbGVhcm4gaG93IHRvIGdpdmUgYmFzaWMgaW5zdHJ1Y3Rpb25zIGxpa2UgKnR1cm4gbGVmdCosICpzdG9wKiwgKmNvbnRpbnVlKiwgdGhpcyBpcyB3aGF0IHlvdXIgY29kZSB3aWxsIGhhdmUgdG8gZG8gKGJ1dCBpbiB0aGUgY29udGV4dCBvZiBhIGxpbmd1aXN0aWNzIGV4cGVyaW1lbnQsIHNvIG1vcmUgbGlrZSAqc2hvdyB0aGlzIHN0aW11bGkqLCAqY29sbGVjdCB0aGlzIGlucHV0KiwgKm1lYXN1cmUgdGhlIHRpbWUgaXQgdGFrZXMgdG8gcHJlc3MgdGhpcyBidXR0b24qKS4KCiMjIFVzaW5nIGNvZ25pdGlvbi5ydW4gd2l0aCBqc1BzeWNoCgpUbyBydW4geW91ciBleHBlcmltZW50LCB5b3Ugd2lsbCBuZWVkIHNvbWV3aGVyZSB0byB3cml0ZSB5b3VyIGNvZGUuIFdlIHdpbGwgdGhlcmVmb3JlIHJldHVybiB0byBgY29nbml0aW9uLnJ1bmAuCgpUaGUgaW1hZ2UgYmVsb3cgb3V0bGluZXMgd2hpY2ggcGFydHMgb2YgdGhlIGludGVyZmFjZSBjYW4gYmUgdXNlZCBmb3IgZGlmZmVyZW50IHB1cnBvc2VzLiBGb3Igbm93LCB3ZSB3aWxsICoqZm9jdXMgb24gMSBhbmQgMioqIG9mIHRoZSBpbnRlcmZhY2UgKHdyaXRpbmcgY29kZSBhbmQgcHJldmlld2luZyBob3cgaXQgbG9va3MpLCB3aXRoIDMgYW5kIDQgYmVpbmcgZXhwbGFpbmVkIGluIG1vcmUgZGV0YWlsIGxhdGVyLgoKIVtdKGltYWdlcy9jb2duaXRpb243LnBuZykKCiMjIDAuIENvbW1lbnRpbmcgeW91ciBjb2RlCgpCZWZvcmUgeW91IHN0YXJ0IHdyaXRpbmcgcHJvcGVyIGNvZGUgdGhhdCBkb2VzIHRoaW5ncywgaXQgaXMgaW1wb3J0YW50IHRvIHJlbWVtYmVyIHRoYXQgaXQgaXMgbm90IGp1c3QgdGhlIGNvbXB1dGVyIHdobyB3aWxsIGludGVycHJldCB5b3Ugd3JpdGUuLi4geW91IGFuZCBvdGhlciBodW1hbiBicmFpbnMgbmVlZCB0byBhcyB3ZWxsLgoKVG8gbWFrZSBpdCBlYXNpZXIgZm9yIGh1bWFucywgeW91IGNhbiBhZGQgKipjb21tZW50cyoqIHRvIHlvdXIgY29kZS4KCkNvbW1lbnRzIGRvbid0IGRvIGFueXRoaW5nIHRvIHlvdXIgYWN0dWFsIGNvZGUsIGJ1dCBhZGQgaW5mb3JtYXRpb24gdG8gbWFrZSBpdCBlYXNpZXIgdG8gdW5kZXJzdGFuZCBhbmQgaW50ZXJwcmV0LiBJbWFnaW5lIHRhbGtpbmcgdG8gc29tZWJvZHkgaW4gYSBsYW5ndWFnZSB0aGF0IHlvdSBib3RoIGtub3csIGJ1dCB0aGVyZSBpcyBzb21lYm9keSBlbHNlIGluIHRoZSBncm91cCB3aG8gZG9lcyBub3Qgc3BlYWsgdGhhdCBsYW5ndWFnZSwgc28geW91IG1pZ2h0IG9mZmVyIGEgc2ltcGxpZmllZCB0cmFuc2xhdGlvbiB0byB0aGF0IHBlcnNvbiwgc28gdGhhdCB0aGV5IGtub3cgd2hhdCBpcyBoYXBwZW5pbmcuIFRoaXMgaXMgc29ydCBvZiBzaW1pbGFyIHRvIHdoYXQgY29tbWVudHMgZG8uCgpZb3UgY2FuIHdyaXRlIGEgY29tbWVudCBpbiB0aGUgY29kZSBzZWN0aW9uIG9mIHRoZSBjb2duaXRpb24ucnVuIGludGVyZmFjZSBpbiB0aGUgZm9sbG93aW5nIHdheToKCmBgYHtqc30KLyogVGhpcyBpcyBhIGNvbW1lbnQgKi8KYGBgCgpUaGVzZSBjYW4gYmUgYXMgbG9uZyBhcyB5b3Ugd2FudCwgYnV0IG11c3QgaGF2ZSBgLypgIGF0IHRoZSBzdGFydCwgYW5kIGAqL2AgYXQgdGhlIGVuZC4KCkxldCdzIHRyeSB3cml0aW5nIGEgdXNlZnVsIGNvbW1lbnQgaW4gb3VyIHNjcmlwdCwgd2hlcmUgd2Ugc2F5OgoKLSB0aGUgdGl0bGUgb2YgdGhlIGV4cGVyaW1lbnQKLSB3aGF0IHZlcnNpb24gb2YganNQc3ljaCB3ZSBhcmUgdXNpbmcKLSB3aGVuIHdlIHdyb3RlIHRoZSBjb2RlIFt0b2RheV0KLSB3aG8gaXMgdGhlIGF1dGhvciBvZiB0aGUgY29kZSBbeW91ciBuYW1lXQoKYGBge2pzfQovKgpUaXRsZTogTXkgZmlyc3QgZXhwZXJpbWVudApqc1BzeWNoIHZlcnNpb246IDcuMy4xCmRhdGU6IFt0b2RheV0KYXV0aG9yOiBbeW91ciBuYW1lXQoqLwoKYGBgCgoKIyMgMS4gSW5pdGlhdGluZyBqc1BzeWNoCgpOb3cgd2UgY2FuIHN0YXJ0IHdyaXRpbmcgYWN0dWFsIGNvZGUgdGhhdCB3aWxsIGFsbG93IHVzIHRvIHVzZSBqc1BzeWNoIHByb3Blcmx5LgoKSW4gb3JkZXIgZm9yIHlvdXIgZXhwZXJpbWVudCB0byB3b3JrLCB0aGUgZmlyc3QgbGluZSBvZiBjb2RlIGluIHlvdXIgc2NyaXB0IHNob3VsZCBiZToKCmBgYHtqc30KdmFyIGpzUHN5Y2ggPSBpbml0SnNQc3ljaCgpOwpgYGAKCk5vdGljZSB0aGF0IHRoaXMgaXMgbm90IGEgY29tbWVudCBhbmQgaGFzIGEgc3BlY2lmaWMgc3RydWN0dXJlLCBvciAqc3ludGF4Kiwgd2hpY2ggaXMgc2hvd24gYnkgdGhlIGNvbG91ciBoaWdobGlnaHRpbmcgb2YgdGhlIHRleHQuIFdlIGNhbiBkZWNvbnN0cnVjdCB0aGlzIHRvIHVuZGVyc3RhbmQgZWFjaCBwYXJ0IG9mIHRoZSBjb2RlOjxici8+PGJyLz4KCi0gYHZhcmAgdGhpcyBpbmRpY2F0ZXMgdGhhdCB3ZSB3YW50IHRvIGNyZWF0ZSBhICp2YXJpYWJsZSosIHdoaWNoIHdlIGNhbiB1c2UgaW4gb3VyIGV4cGVyaW1lbnQuPGJyLz5Ob3RpY2UgdGhhdCBpdCBpcyBpbiBhIGRpZmZlcmVudCBjb2xvdXIgdG8gdGhlIHJlc3Qgb2YgdGhlIHRleHQsIHRoaXMgaXMgYmVjYXVzZSBpdCBpcyBhICprZXl3b3JkKiB0aGF0IGphdmFzY3JpcHQgdW5kZXJzdGFuZHMgdG8gYmUgaW1wb3J0YW50LCBpLmUuIHRoYXQgeW91IHdhbnQgdG8gY3JlYXRlIGEgdmFyaWFibGUuPGJyLz48YnIvPgoKLSBganNQc3ljaGAgdGhpcyBpcyB0aGUgbmFtZSBvZiBvdXIgdmFyaWFibGUsIGluIHRoZW9yeSB5b3UgY2FuIG5hbWUgdmFyaWFibGVzIGFueXRoaW5nIHRoYXQgeW91IHdhbnQuPGJyLz48YnIvPgogICAgCi0gYD1gIHRoaXMgaXMgYW4gKm9wZXJhdG9yKiBpdCBpcyB1c2VkIHRvIGFzc2lnbiBhIHZhbHVlIHRvIGEgdmFyaWFibGUsIGluIHRoaXMgY2FzZSB3aGF0ZXZlciBpcyBvbiB0aGUgcmlnaHQgb2YgdGhlIGVxdWFscyBzaWduIHdpbGwgYmUgYXNzaWduZWQgdG8gb3VyIGpzUHN5Y2ggdmFyaWFibGUuPGJyLz48YnIvPgoKLSBgaW5pdEpzUHN5Y2goKWAgdGhpcyBpcyBhIGZ1bmN0aW9uIHNwZWNpZmljYWxseSBtYWRlIGZvciBqc1BzeWNoIGV4cGVyaW1lbnRzLCBpdCBhbGxvd3MgdXMgdG8gaW5pdGlhdGUgYW4gZXhwZXJpbWVudCwgd2l0aG91dCB0aGlzIGZ1bmN0aW9uIHdlIHdvdWxkIG5vdCBiZSBhYmxlIHRvIGRvIGFueXRoaW5nLiBUaGluayBvZiBpdCBhcyB0dXJuaW5nIG9uIHRoZSBwb3dlciBidXR0b24sIG5vdGhpbmcgd2lsbCBoYXBwZW4gdW50aWwgeW91IGhhdmUgdGhpcyBmdW5jdGlvbiBzdG9yZWQgYXMgYSB2YXJpYWJsZS48YnIvPjxici8+CgotIGA7YCB0aGlzIGlzIGEgc2VtaS1jb2xvbiwgaXQgaXMgYW4gaW1wb3J0YW50IHBhcnQgb2YgeW91ciBjb2RlIGFzIGl0IHdpbGwgYWxsb3cgdGhlIHNjcmlwdCB0byBrbm93IHRoYXQgeW91ciBzcGVjaWZpYyBiaXQgb2YgY29kZSAob3Igc3RhdGVtZW50KSBpcyBmaW5pc2hlZCBhbmQgeW91IGNhbiBtb3ZlIG9uIHRvIHlvdXIgbmV4dCBvbmUuPGJyLz48YnIvPgoKYGBge3IgZWNobz1GQUxTRSwgZXZhbD1UUlVFfQptZXNzYWdlKHBhc3RlKCI8Yj5XaGF0IGlzIGEgdmFyaWFibGU/PC9iPjxici8+PGJyLz4iLAogICAgICAgICAgICAgICJTZWUgW3RoaXNdKGh0dHBzOi8vd3d3LmZyZWVjb2RlY2FtcC5vcmcvbmV3cy9qYXZhc2NyaXB0LXZhcmlhYmxlcy1iZWdpbm5lcnMtZ3VpZGUvKSBwYWdlIGZvciBtb3JlIGluZm9ybWF0aW9uIG9uIHdoYXQgYHZhcmAgbWVhbnMuPGJyLz48YnIvPiIsCiAgICAgICAgICAgICAgIjxiPkNob29zaW5nIGEgbmFtZSBmb3IgeW91ciB2YXJpYWJsZTwvYj48YnIvPjxici8+IiwKICAgICAgICAgICAgICAiV2hlbiBuYW1pbmcgeW91ciB2YXJpYWJsZSB5b3Ugc2hvdWxkIGZvbGxvdyB0aGVzZSBydWxlczo8YnIvPjxici8+IiwKICAgICAgICAgICAgICBwYXN0ZTAoZmEoImNpcmNsZS14bWFyayIsIGZpbGwgPSAicmVkIiksICIgbmV2ZXIgaW5jbHVkZSBzcGFjZXMgKHVzZV91bmRlcnNjb3Jlc19pbnN0ZWFkKTxici8+IiksCiAgICAgICAgICAgICAgcGFzdGUwKGZhKCJjaXJjbGUteG1hcmsiLCBmaWxsID0gInJlZCIpLCAiIG5ldmVyIGJlZ2luIHdpdGggYSBudW1iZXI8YnIvPiIpLAogICAgICAgICAgICAgIHBhc3RlMChmYSgiY2lyY2xlLXhtYXJrIiwgZmlsbCA9ICJyZWQiKSwgIiBuZXZlciB1c2UgYSBzcGVjaWFsIGphdmFzY3JpcHQgbmFtZSAoZS5nLiAndmFyJyBpcyBub3QgYSBnb29kIG5hbWUgZm9yIHlvdXIgdmFyaWFibGUpPGJyLz48YnIvPiIpLAogICAgICAgICAgICAgIHBhc3RlMChmYSgiY2lyY2xlLWNoZWNrIiwgZmlsbCA9ICJncmVlbiIpLCAiIGFsd2F5cyBtYWtlIHRoZW0gdW5pcXVlIHRvIG90aGVyIHZhcmlhYmxlczxici8+IiksCiAgICAgICAgICAgICAgcGFzdGUwKGZhKCJjaXJjbGUtY2hlY2siLCBmaWxsID0gImdyZWVuIiksICIgYWx3YXlzIG1ha2UgdGhlbSBtZW1vcmFibGU8YnIvPiIpLAogICAgICAgICAgICAgIHBhc3RlMChmYSgiY2lyY2xlLWNoZWNrIiwgZmlsbCA9ICJncmVlbiIpLCAiIGFsd2F5cyBiZSBhd2FyZSBvZiB1cHBlciBhbmQgbG93ZXIgY2FzZSAoJ215VmFyaWFibGUnIHdpbGwgYmUgZGlzdGluY3QgZnJvbSAnbXl2YXJpYWJsZScpPGJyLz48YnIvPiIpLAogICAgICAgICAgICAgICI8Yj5XaGF0IGdvZXMgaW5zaWRlIHRoZSBicmFja2V0cz88L2I+PGJyLz48YnIvPiIsCiAgICAgICAgICAgICAgIldoZW4geW91IHNlZSBicmFja2V0cyBmb3IgYSBmdW5jdGlvbiwgdGhlcmUgYXJlIG5vcm1hbGx5IHNvbWUgYWRkaXRpb25hbCBwYXJhbWV0ZXJzIHRoYXQgeW91IGNhbiBzZXQsIHRvIHNlZSB3aGF0IHRoZXNlIGFyZSB5b3UgY2FuIGFsd2F5cyByZWZlciB0byB0aGUgb2ZmaWNpYWwgW2pzUHN5Y2ggZG9jdW1lbnRhdGlvbl0oaHR0cHM6Ly93d3cuanNwc3ljaC5vcmcvNy4zL3JlZmVyZW5jZS9qc3BzeWNoLyksIGZvciBub3cgd2Ugd2lsbCBrZWVwIG91ciBleHBlcmltZW50IHRvIHRoZSBkZWZhdWx0IHNldHRpbmdzLCBzbyB3ZSBkbyBub3QgbmVlZCB0byBhZGQgYW55dGhpbmcgaW5zaWRlIHRoZSBicmFja2V0cy48YnIvPjxici8+IgogICAgICAgICAgICAgICkpCgpgYGAKCgpgYGB7ciBlY2hvPUZBTFNFLCBldmFsPVRSVUV9Cm1lc3NhZ2UocGFzdGUoIjxiPkltcG9ydGFudCBkaWZmZXJlbmNlcyBiZXR3ZWVuIGNvZ25pdGlvbi5ydW4gYW5kIG5vcm1hbCBqc1BzeWNoIGV4cGVyaW1lbnRzPC9iPiIsCiAgICAgICAgICAgICAgIllvdXIgZXhwZXJpbWVudCBpbiBjb2duaXRpb24ucnVuIHdpbGwgbG9vayBhIGJ1dCBkaWZmZXJlbnQgZnJvbSBvdGhlciBKc1BzeXNjaCBleHBlcmltZW50cywgZS5nLiB0aGUgb25lcyB5b3UgbWlnaHQgc2VlIHRoYXQgd2VyZSBob3N0ZWQgb24gcHJpdmF0ZSBzZXJ2ZXJzLiBUaGlzIGlzIGJlY2F1c2UgY29nbml0aW9uLnJ1biBkb2VzIHNvbWUgdGhpbmdzIGF1dG9tYXRpY2FsbHksIHNvIHlvdSBkbyBub3QgbmVlZCB0byB3b3JyeSBhYm91dCBhZGRpbmcgc3BlY2lmaWMgY29kZS4iLAogICAgICAgICAgICAgICJPbmUgb2YgdGhlIG1haW4gZGlmZmVyZW5jZXMgaXMgdGhhdCBhbGwgb2YgdGhlIHN0YW5kYXJkIEpzUHN5Y2ggcGx1Z2lucyBhcmUgYXV0b21hdGljYWxseSBsb2FkZWQgZm9yIHlvdS4gV2Ugd2lsbCBkaXNjdXNzIHRoaXMgbGF0ZXIgaW4gdGhlIHdvcmtzaGVldCwgYnV0IGlmIHlvdSBoYXZlIHVzZWQgSnNQc3ljaCBiZWZvcmUsIG9yIGFyZSBjb3B5aW5nIGNvZGUgZnJvbSBhIG5vbiBjb2duaXRpb24ucnVuIGV4cGVyaW1lbnQgeW91IG1pZ2h0IG5lZWQgdG8gYmUgYXdhcmUgb2YgdGhpcy4iLAogICAgICAgICAgICAgICJFc3NlbnRpYWxseSwgdGhlIGNvZGUgeW91IGhhdmUgaW4geW91ciBjb2duaXRpb24ucnVuIGV4cGVyaW1lbnQgd2lsbCBhbGwgYmUgamF2YXNjcmlwdCwgd2hlcmVhcyBhIHR5cGljYWwgSnNQc3ljaCBleHBlcmltZW50IHdpbGwgYmUgYSBodG1sIGZpbGUsIHdpdGggdGhlIGphdmFzY3JpcHQgZW1iZWRkZWQgd2l0aGluIHRoYXQgZmlsZS4iLAogICAgICAgICAgICAgIHNlcCA9ICI8YnIvPjxici8+IikpCgpgYGAKCgpgYGB7ciBlY2hvPUZBTFNFLCBldmFsPVRSVUUsIG91dC53aWR0aD0iOTAlIn0Ka25pdHI6OmluY2x1ZGVfdXJsKCJjb2RlX2V4YW1wbGVzL1VudGl0bGVkMS5odG1sIikKCmBgYAoKCgoKCmBgYHtyIGVjaG89RkFMU0UsIGV2YWw9VFJVRSwgd2FybmluZz1GQUxTRX0KaHRtbHRvb2xzOjp0YWdzJHNjcmlwdChzcmMgPSAianMvdHJhbnNsYXRlLmpzIikKIyBodG1sdG9vbHM6OnRhZ3Mkc2NyaXB0KHNyYyA9ICJqcy9pbmZvYm94LmpzIikKaHRtbHRvb2xzOjp0YWdzJHNjcmlwdChzcmM9Ii8vdHJhbnNsYXRlLmdvb2dsZS5jb20vdHJhbnNsYXRlX2EvZWxlbWVudC5qcz9jYj1nb29nbGVUcmFuc2xhdGVFbGVtZW50SW5pdCIpCgpodG1sdG9vbHM6OnRhZ0xpc3QoCiAgeGFyaW5nYW5FeHRyYTo6dXNlX2NsaXBib2FyZCgKICAgIGJ1dHRvbl90ZXh0ID0gIjxpIGNsYXNzPVwiZmEgZmEtY2xpcGJvYXJkXCIgc3R5bGU9XCJmb250LXNpemU6IDI1cHhcIj48L2k+IiwKICAgIHN1Y2Nlc3NfdGV4dCA9ICI8aSBjbGFzcz1cImZhIGZhLWNoZWNrXCIgc3R5bGU9XCJjb2xvcjogIzkwQkU2RDsgZm9udC1zaXplOiAyNXB4XCI+PC9pPiIsCiAgKSwKICBybWFya2Rvd246Omh0bWxfZGVwZW5kZW5jeV9mb250X2F3ZXNvbWUoKQopCgpgYGAKCmBgYHtqcyBlY2hvPUZBTFNFLCBldmFsPVRSVUV9CnZhciBjb2xsID0gZG9jdW1lbnQuZ2V0RWxlbWVudHNCeUNsYXNzTmFtZSgiY29sbGFwc2libGUxIik7CnZhciBpOwoKZm9yIChpID0gMDsgaSA8IGNvbGwubGVuZ3RoOyBpKyspIHsKICBjb2xsW2ldLmFkZEV2ZW50TGlzdGVuZXIoImNsaWNrIiwgZnVuY3Rpb24oKSB7CiAgICB0aGlzLmNsYXNzTGlzdC50b2dnbGUoImFjdGl2ZTEiKTsKICAgIHZhciBjb250ZW50ID0gdGhpcy5uZXh0RWxlbWVudFNpYmxpbmc7CiAgICBpZiAoY29udGVudC5zdHlsZS5tYXhIZWlnaHQpewogICAgICBjb250ZW50LnN0eWxlLm1heEhlaWdodCA9IG51bGw7CiAgICB9IGVsc2UgewogICAgICBjb250ZW50LnN0eWxlLm1heEhlaWdodCA9IGNvbnRlbnQuc2Nyb2xsSGVpZ2h0ICsgInB4IjsKICAgIH0KICB9KTsKfQoKYGBgCg==